Returns a handle to the next GDevice structure in the device list.

GDHandle GetNextDevice (
    GDHandle curDevice
);

curDevice

A handle to the GDevice structure at which you want the search to begin.

function result

A handle to the next device. If there are no more GDevice structures in the list, NULL.

DISCUSSION

After using any of the functions GetDeviceList, GetGDevice, GetMainDevice, or GetMaxDevice to obtain a handle to a GDevice structure, use the GetNextDevice function to obtain a handle to the next GDevice structure in the list.

SPECIAL CONSIDERATIONS

The GetNextDevice function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)